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80 Column Display 
by Batteries Included 


Thank you for purchasing BI-80. 

We believe that BI-80 Is the best 80 column display available 
for the Commodore 64. BI-80 provides a crystal clear 80 column 

display and powerful Basic 4.0 language extension. BI-80 
Installs easily and Is compatible with many programs Including 
the PaperCllp64 wordprocessor and the Consultant database. 

Again, Thank you for choosing BI-80. 


Batteries Included. 


Batteries Included 
186 Queen Street West 
Toronto, Ontario 
Canada, M5V-1Z1 
(416) 596-1405 

Copyright 1984 by Batteries Included 

AlI Rights Reserved 

Programming: Steven Douglas 
Hardware design: PHE 
Produced by Batteries Included 

Second Edition 

NOTICE OF REGISTERED TRADEMARK 

Reference Is made In several places In this 
manual to Commodore and Commodore 64 which 
are registered trademarks of Commodore 
Business Machines Inc. 


BI —80 OWNERS MANUAL 
COPYRIGHT 1984 BY BATTERIES INCLUDED 
186 Queen Street West 
TORONTO, ONTARIO CANADA, M5V 1Z1 
(416) 596-1405 

This manual and the computer programs contained In or transferred from the 
BI-80 ROM chip which are described by this manual are copyrighted and 
contain proprietary Information belonging to Batteries Included. 

This manual may not be copied, photocopied, reproduced, translated or 
reduced to machine readable form. In whole or in part, without the prior 
written consent of Batteries Included. 

The ROM chip, and Information contained within It, may not be duplicated. 
In whole or In part, fcr any purpose. No copies of this manual or the 
listings of the programs In the ROM chip may be sold or given to any person 
or other entity. 


LIMITATIONS OF WARRANTY AND LIABILITY 

Batteries Included, or any dealer or distributor distributing this product, 
makes NO WARRANTY, EXPRESS OR IMPLIED, with respect to this manual, the 
BI-80 software, hardware and any other related Items, their quality, 
performance, merchantability, or fitness for any particular use. It Is 
solely the purchaser's responsibility to determine their suitability for 
any particular purpose. 

Batteries Included will In no event be held liable for direct. Indirect or 
Incidental damages resulting from any defect or emission In this manual, 
the BI-80 ROM, the BI-80 hardware, the software contained within the ROM 
chip, or other related Items and processes. Including but not limited to 
any Interruption of services, loss of business or anticipatory profit, or 
other consequential damages. 

THIS STATEMENT OF LIMITED LIABILITY IS IN LIEU OF ALL OTHER WARRANTIES, 
EXPRESS OR IMPLIED, INCLUDING WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 
A PARTICULAR PIRPOSE. Batteries Included neither assumes nor authorizes 
any other person to assume for It any other warranty or liability In 
connection with the sale of Its products. 

PR00UCT IMPROVEMENTS 

Batteries Included reserves the right to make corrections or improvements 
to this manual and to the related BI-80 device at any time without notice 
and with no responsibility to provide these changes to purchasers of 
earlier versions of its products. 
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InstalI Ins BI-8Q 


Unpacking 

Before Installing the BI—80 In your Commodore 64 check the 
package you received to make sure you have everything listed 
below. 

- BI—80 80 Column display adapter 

- BI—80 cables (male phono to male phono) 

(male phono to female phono) 

- Warranty registration card 


In addition, you should have on hand the following: 

- Commodore monitor or any good color or monochrome monitor. 


Installatlan 

Make sure that the power for your Commodore 64 computer Is 
disconnected and that any cartridges are removed. Insert the 
BI—80 Into the cartridge slot of your computer. Make sure It Is 
fully seated In the connector. Turn the computer on again. It 
should power up and display the slgn-on message as In Figure 1. 
Turn the unit off. 

Remove the cable from the luminance connection on the back of 
your monitor. Connect the male phono to male phono cable from 
the connector on the right rear corner of the BI-80 (to monitor) 
to the luminance connection on your monitor. Connect the female 
end of the male to female phono cable to the cable you unplugged 
from your monitor. Connect the male end to the left rear 
connection on the BI—80 (from computer). Refer to Figure 2. 
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Commodore Personal Computer 



Monitor Cable 



BI -80 


General Configuration 


General Configuration 

BI —80 transforms your Commodore 64 Into a powerful 80 column 
computer. Your screen can now display a crystal clear 80 
columns by 25 lines and Basic 4.0 provides powerful disk 
commands with both 40 and 80 column displays. 

When the Commodore 64 is first turned on with the BI-80 
connected, the 40 column display Is selected. The Basic 4.0 
language extension Is active. To enable the 80 column display 
enter the command SYS 33000. The 80 column display will appear. 
To return to the 40 column system enter the command SYS 33003. 

BI-80 reduces the amount of memory available for the Basic 
language by 8K. If you have to remove the BI-80 to allow a 
program to operate you will have to unplug the video cables. 



BI-8Q 


Basic 4.0 

Basic 4.0 Is a set of additional commands added to the regular 
set available In the standard Basic 2.0 language. This section 
Is Intended to outline and explain In simple terms the 
additional commands available with the Basic 4.0 language. It 
Is not Intended to teach programming or explain In detail the 
techniques which can utilize these commands. For more 
comprehensive Information the following sources may be useful: 

User's Reference Manual - Commodore BASIC Version 4.0 
Part# J2I604 - Commodore Business Machines Inc. 

User's Manual for CBM 5 l/4-lnch Dual Floppy Disk Drives 
Part# 320899 - Commodore Business Machines Inc. 

PET PERSONAL COMPUTER GUIDE 

- Adam Osbourne, Jim Strasma, Ellen Strasma 

Copyright 1982 - Osbourne/McGRaw-H11 I - ISBN 0-931988-76-4 

The following convention has been used for the Basic 4.0 command 
descriptions. Commands are In UPPER case, variable data Is In 
lower case. Square brackets [ and ] Indicate an optional 
parameter. Quotes "" Indicate that a string constant or 
variable Is required. Angle brackets <> Indicate that a 
constant or variable may be used. In most cases variables must 
be enclosed In brackets () to avoid a SYNTAX ERROR. 


Turning Bas i c 4.0 QN and Off 

When the computer is first powered on the 8aslc 4.0 language 
extension Is enabled. To disable the Basic 4.0 language and 
return operation to the standard Basic 2.0 language enter the 
command SYS 33009 . Enable It with SYS 33006 . Do NOT enable 
or disable the Basic 4.0 language from within a Basic program - 
only from the keyboard In Immediate mode. 
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BI-80 


Basic 4.Q 


OS. and PS* tOLsK Status) 

Because the disk drive controller Is a separate computer, any 
errors It encounters during operation must be manually retrieved 
from the drive to the computer. Error messages are usually 
indicated by a RED centre light on dual slot drives, or a 
rapidly flashing RED light on single slot drives. Basic 4.0 can 
retrieve and display an error message from the disk drive simply 
by referring to the pseudo-variables OS and DS$. DS and DS$ are 
used as If they were regular Basic variables, except that you 
cannot assign values to them. Instead, when you refer to either 
DS or DSJ after Issuing a disk related Basic 4.0 command (such 
as DSAVE), the computer will fetch the current error status of 
the disk unit last referred to and store the resulting string in 
DSt. The first number In the DSS string Is stored In DS - this 
Is known as the error code. It Is Important to note that DS and 
DSJ are only updated when you refer to them AND a disk related 
command has been Issued since the last reference to DS or DSS. 
If you refer to DS or DSJ and a disk command has not been Issued 
since the last reference, then the current values ere reused and 
the drive Is not queried. This allows programming of the form: 
IF OS <> 0 THEN PRINT DSS : STOP 

There are three messages which are not errors (and do not light 
the error lamp) which may be retrieved by DS and DSS. 

73, cbm dos v.,00,00 - This message waits In the drive after 

power-up until a command Is executed. 

00, ok,00,00 - This Is the message returned If the previous 
command was executed with no errors. It Is also returned when 
there was an error. DS or DSS was referenced, and for some 
reason the drive was queried a second time without any disk 
command being Issued (this normally shouldn't happen since DS 
and DSS keep track of disk commands). 

01, files scratched.xx,00 - This message Is only returned after 
a SCRATCH command Is executed by the drive. The two digits 'xx' 
Indicate the number of flies actually scratched by the drive - 
It will be zero If no files were scratched. 

Note 1: If no device responds to Basic 4.0's request for the 
disk message then DS will have a value of 0 to 20. DSS will 
have a length of zero. 

Note 2: The act of fetching DS or DSS will cause ST to be 
changed - therefore you must save ST before checking DS and DSS 
If ST Is needed later In the program. 
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ST Is used as If It was a regular Basic variable, except that 
you cannot assign a value to It. It Is used as a variable which 
contains the result of the last attempted I/O operation. The 
value will vary depending on the success of the I/O with the 
various bits indicating exact nature of the problem. 


TMiiu 11ii-aiil‘l MJMI33 


0 

1 

time out on write 

1 

2 

time out on read 

2 

4 

none 

3 

8 

none 

4 

16 

none 

5 

32 

none 

6 

64 

EOI (end or Identify] 

7 

-128 

device not present 


Status values of I and 2 Indicate that the device you are trying 
to communicate with Is not accepting or sending data. For 
Instance If when reading from a sequential file the program 
attempts to read more data than exists In the file, the drive 
will TIME OUT ON READ and status will equal 2. A status value 
of 64 on reading from a file Indlctes that the last date Item 
fetched Is the last data Item In the file and there are no more 
to follow The computer often generates a status of 64 when It 
Is sending data to the disk drive or printer. If status Is 
-128, then the device number you are trying to communicate with 
does not exist. 


The Commodore DOS systems allow considerable flexibility In 
specifying which files a command will act upon. For example. If 
you wished to scratch (delete) a file or group of files, you 
could specify the file name In many different ways: 

fred -the single file 'fred 1 

fred* -all files starting with the characters 'fred 1 

fr?d -all files matching 'fr?d'. where '?' Is any character 

fr?d* -all files matching 'fr?d' with anything following 

0:fred -the file 'fred' on drive 0 

l:fred* -all files on drive I starting with 'fred' 

fred=prg -the program file 'fred' 

0:f*=seq -all sequential files on drive 0 which start with 1 f 1 
l:*=rel -all relative files on drive 1 

Many disk commands can use some or all of the methods shown 
above to specify files. Others will require a specific format 
as described In the Individual commands. 
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B1 —80 


Basic 4.0 


Basic \ I [) mwinnfl'l 

APPEND 

Format - APPEND# <flle number> , "<name>" [,0<x>] [ON U<y>J 

Use - To add additional data to the end of a sequential disk 
file. 

Notes - APPEND Is used like a DOPEN command but can only be 
used to add data to an existing sequential disk file. 
APPEND opens the specified data file for write and 
positions the DOS pointers to the current end of the 
file and new data can be added. Any variable or 
evaluated expressions must be enclosed In parentheses. 
Unit defaults to device 8, drive 0. 

Example - x=l : APPENDIt "data file", D(x> ON U 9 

Opens a file with a logical number of I called 
"data file" on drive I of unit 9 for append. 


BACKUP 




Format 

- BACKUP D<x> to D<y> [ON U<z>j 



Use 

- To create an exact duplicate of a diskette 
dual drive 

using a 

Notes 

- Not applicable for single slot drives. 
Both drive numbers must be specified and 

1 Unit defaults to device 8. Any 

evaluated expressions must be enclosed In 

must be 0 and 
variable or 
parentheses. 

Example 

- BACKUP DO to D1 
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Basi c 4 .0 


CATALOG or DIRECTORY 

Format - CATALOG ["<pattern>",] [0<x>] [ON U<y>] 

DIRECTORY ["<pattern>",D [0<x>] [ON U<y>] 

Use - Displays on the current output device (usually the 
screen) the disk directory from the specified drive. 
If no drive Is specified both drives are searched In a 
dual drive. Any variable or evaluated expressions 
must be enclosed In parentheses. Unit defaults to 
device 8. Pattern matching as described on Page 3-3 
may be used to view limited segments of the directory- 
Pressing the SPACE bar will cause the scroll of the 
display to pause, pressing It again will continue the 
display. STOP terminates the listing. 

Example - CATALOG 00 ON U 9 

DIRECTORY 00 "fred*" 


COII FCT 

Format - COLLECT [0<x>] [ON U <y>] 

Use - Causes the disk drive to review the block allocations 
for all flies In the directory. deleting all 
Incorrectly closed flies (those marked with an 
asterisk In the directory). The block count and 
allocation map are updated to correspond correctly to 
the files currently on the disk. Space allocated by 
the BLOCK-ALLOCATE command is freed since It Is not 
linked to the directory. Any variable or evaluated 
expressions must be enclosed In parentheses. Unit 
defaults to device 8, drive 0 

Example - COLLECT 00 


CONCAT 

Format - CONCAT [0<x>,3 <"namea"> TO [0<y>.] "nameb" [ON U<z>D 

Use - Causes the sequential file "nameb" to have the data In 
"namea" appended to It. The data In the file "namea" 
, Is unaltered. Can only be used with sequential data 

files. Any variable or evaluated expressions must be 
enclosed In parentheses. Unit defaults to device 8, 
drive 0 . 

Example - CONCAT "two" TO "one" ,01 

creates file "one" which contains "one" + "two" 
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COPY 

Format - COPY [D<x>,D "<namea>" TO [D<y>,3 "<nameb>" [ON U<z>3 

or - COPY D<x> TO D<y> [ON U<z>D 

Use - causes the disk drive to copy a file or files from one 
place to another within a disk unit. It can be used 
to copy data from one disk to another In a dual drive 
and to copy a file to another place on the same 
diskette. Pattern matching as described on Page 3-3 
may be used to copy multiple flies. If the file Is to 
be copied to the same diskette then "nameb" must 
differ from "namea". COPY without file names copies 
all files from one diskette to the other In a dual 
drive without erasing those already there. Any 
variable or evaluated expressions must be enclosed In 
parentheses. Unit defaults to device 8. 

Example - COPY DO to D1 

COPY 01 "temp" TO "tempb" 


DCLQSE 

Format - 0CL0SE [*<x>] [ON U<y>] 

Use - Close one or many currently open disk files. DC10SE 
will only close those disk files which were currently 
open In the computer's Internal file table. If a 
logical file number <x> Is specified then only that 
file will be closed. If only the unit number <y> is 
specified then all files on that unit will be closed. 
If both logical and unit numbers are specified then 
the unit number Is Ignored. If no parameters are 
given then all disk files will be closed. Relative 
record files may have more records generated at close 
time than were actually written In order to fill out 
the sectors In use. Any variable or evaluated 
expressions must be enclosed In parentheses. Unit 
defaults to device 8. 

Example - DCLOSE :closes all files currently open on device 8 
DCL0SEI2 sclose the file with logical number 2 
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Basic A^D 


DLQAD 

Format - OLOAD "<name>" [,D<x>] [ON U<y>] 

Use - Load a Basic program from disk, relocating It If 

necessary. Any variable or evaluated expressions must 
be enclosed In parentheses. Pattern matching as 
described on Page 3-3 may be used. If an asterisk (*) 
Is used as the filename the last accessed program on 
the disk will be loaded (If you exchange diskettes 
after the first load then this will not work). If the 
last file accessed was not a program file then the 
first program file In the disk directory will be 

loaded. Unit defaults to device 8. If no drive Is 
specified both drives are searched In a dual drive. 
If used In program mode the subsequently loaded 
program will begin execution with the first line. 

Example - DLOAO "first file" ,D1 

DOPEN 

Format - DOPEN# <a> , "<name>" [,L<y>] [,0<x>D [ON U<z>] [,W] 

Use - Open a sequential or random access file for read or 

write. <a> Is the logical file number. Logical file 
numbers greater than 127 cause each PRINT# statement 
to transmit a LINE FEED character and a CARRIAGE 
RETURN character. The L<y> parameter only needs to be 
specified when opening a relative record file for the 
first time. Relative record files are always opened 
for both read and write. If not specified, sequential 
files are opened for read. Any variable or evaluated 
expressions must be enclosed In parentheses. Unit 
defaults to device 8, drive 0. Both drives In a dual 
drive will be searched If all the optional parameters 
are missing. If the first character of the filename 
Is the 8 (at) symbol It Is removed and the specified 
file Is opened replacing any existing file with that 
name provided that the file type Is the same. 

Example - DOPEN# 5 , "fred" , L 27 , Dt 

open a relative file, record length of 27 bytes, on 
drive 1 

DOPEN# 2 , "Babe file". W 

opens sequential file on drive 0 for write with a 
logical file # of 2. 

If "abc file" previously existed It has now been 
rep Iaced. 
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Basic 4.0 


DSAVE 

Format - DSAVE "<name>“ [,0<x»] [ON U<y>] 

Use - Save a Basic program to disk. The "name" parameter 
can be up to 16 characters long. Any variable or 
evaluated expressions must be enclosed In parentheses. 
Unit defaults to device 8, drive 0. If the first 
character of the filename Is the 6 (at) symbol. It Is 
removed and the specified file replaces any existing 
file with that name provided that the file type Is the 
same. 

Example - DSAVE "my program" ,01 
DSAVE "*freds prog" 

save "freds prog" on drive 0 replacing any previous 
program file named "freds prog". 


HEADER 

Format - HEADER ”<dlsk name>" [,0<x>3 [I<zz>3 [ON U<y>3 

Use - To format (nex) a nex disk or erase the contents of an 
old one. The <dlsk name> may be up to 16 characters 
long. A 'STRING TOO LONG error will occur If the 
<dlsk name> Is greater than 16 characters long. If 
the I< 22 > parameter Is missing then the drive will 
attempt to reformat only the directory track. The 
< 22 x parameter may be specified as a string variable. 
Any variable or evaluated expressions must be enclosed 
In parentheses. Unit defaults to device 8, drive 0. 

When used In Immediate mode the question 
'ARE YOU SURE?' x111 be asked before the command 
proceeds. Ansxer Y or YES to continue. N to abort. 
On completion the screen xl I I display READY If the 
disk xas correctly formatted or BAD DISK If any error 
xas encountered. The actual error can be displayed by 
printing the contents of DSJ. 

CAUTION: The HEADER command all I erase all Information 
previously stored on the disk! Be careful I 

Example - HEADER "my first disk" , D1 ON U 8 , Ibz 
HEADER "next disk" 


Page 3-8 



BI-80 


Basic 4.0 


•RECORD 

Format 

Use 


Example 

RENAME 

Format 

Use 

Examp Ie 


- RECORD# <loglcal flle#> , <record#> [,<byte position)] 

- Used before a GET#, INPUT# or PRINT# statement to 
position to the correct record number In a random 
access data file opened with the <log I cal file 
number>. <record#> must be between 1 and 65535 
Inclusive. <byte posltlon> must be between I and 254 
Inclusive. <byte position) defaults to I If omitted. 
Any variable or evaluated expressions must be enclosed 
In parentheses. 

If the <record#> causes the pointer to be positioned 
beyond the current end of file (as It would be when 
adding data to the file) the disk status (OSS> will 
show a RECORD NOT PRESENT error. If the Intent Is to 
add data to the file, then the next PRINT# statement 
will cause that record and any necessary Intervening 
records to be generated. If INPUT# Is executed then a 
null value Is returned with STATUS (ST) set to E0I 
(64). 

- RECORD# 1 402 , 5 

positions to byte 5 of record 402 


RENAME [D<X>,D "<old name)" TO "<new name)" [ON U<y)] 

Changes the name of a specified disk file. The file 
must not be currently open. Any variable or evaluated 
expressions must be enclosed In parentheses. Unit 
defaults to device 8, drive 0. It Is not possible to 
RENAME a file to a name already existing on the disk. 

RENAME "freds file" TO "my file" . 01 
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SCRATCH 

Format - SCRATCH "<name>" [,0<x>3 [ON U<y>] 

Use - Erase a disk file or files. Any variable or evaluated 
expressions must be enclosed In parentheses. Unit 
defaults to device 8, drive 0. When used In Immediate 
mode the question 'ARE YOU SURE?' will be asked before 
the command proceeds. Answer Y or YES to continue, N 
to abort. Multiple flies may be scratched at one time 
by using the pattern matching as described on Page 
3-3 

Example - SCRATCH "my file" 

erase only "my file" from drive 0 

SCRATCH "fred*" ,dl 

erase all flies on drive I beginning with "fred" 

AUIO RUN tshltt RUM/STOPt 

Format - Press the RUN/STOP key while holding the SHIFT key 

Use - Pressing the RUN/STOP key while holding the SHIFT key 
down will cause the computer to load and run the first 
program on drive 0 of device 8. 
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Appendix A 


Theory nl operation 


The BI—80 display acts as an 8K cartridge residing at $8000. On 
power up the Basic 4.0 Is engaged, the 80 column screen 
initialized, cleared and the standard 40 column screen Is 
dlsplayeo. The Basic 4.0 language Is separate from the 80 
column system and can be enabled and disabled without affecting 
the 80 column operation. The 80 column screen memory resides at 
$9800 to S9FFF. If the Iomem control bit In the 6510 Is turned 
off, the B1-80 ROM at $8000 Is disabled, but the screen RAM Is 
not. Any write to memory from $9800 to S9FFF will write to both 
the memory In the computer and In the BI-80. 


Several vectors are available In the BI-80 display. 

The BI-80 ROM Is coded with the string 'batteries Included' 
starting at address 32777 ($8009). 

Vector Operation 


dec 1ma 1 
33000 

hex 

S80E8 

- Engage 80 column operating system. 

Initialize hardware, switch to 80 column 
display. 

33003 

S80EB 

- Engage standard 40 column operating system, 
switch to 40 column display 

33006 

S80EE 

- Enable BASIC 4.0 language extension. 

(Note: Basic 4.0 Is enabled on power up). 

33009 

S80F t 

- Disable Basic 4.0 language extension. 

33012 

S80F4 

- Initialize 6545 CRTC chip, switch to 80 column 
display, (80 columns, 25 lines). 

33015 

S80F7 

- Install 80 column operating system vectors. 

33018 

$80FA 

- Print copyright message, 

(Batteries Included Vx.x (C) 1984). 

33021 

S80FD 

- Switch to 40 column display 
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